<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Obtaining the mysqlnd plugin API</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="mysqlnd.plugin.mysql-proxy.html">« A comparison of mysqlnd plugins with MySQL Proxy</a></li>
      <li style="float: right;"><a href="mysqlnd.plugin.architecture.html">MySQL Native Driver Plugin Architecture »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="mysqlnd.plugin.html">MySQL Native Driver Plugin API</a></li>
    <li>Obtaining the mysqlnd plugin API</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="mysqlnd.plugin.obtaining" class="section">
  <h2 class="title">Obtaining the mysqlnd plugin API</h2>
  <p class="para">
   The <code class="literal">mysqlnd</code> plugin API is simply part of the MySQL
   Native Driver PHP extension, <code class="literal">ext/mysqlnd</code>.
   Development started on the <code class="literal">mysqlnd</code> plugin API in
   December 2009. It is developed as part of the PHP source repository,
   and as such is available to the public either via Git, or through
   source snapshot downloads.
  </p>
  <p class="para">
   Plugin developers can determine the <code class="literal">mysqlnd</code>
   version through accessing <code class="literal">MYSQLND_VERSION</code>, which
   is a string of the format <q class="quote">mysqlnd 5.0.7-dev - 091210 -
   $Revision: 300535</q>, or through
   <code class="literal">MYSQLND_VERSION_ID</code>, which is an integer such as
   50007. Developers can calculate the version number as follows:
  </p>
  <table id="mysqlnd.plugin.version-id" class="doctable table">
   <caption><strong>MYSQLND_VERSION_ID calculation table</strong></caption>
   
    <thead>
     <tr>
      <th>Version (part)</th>
      <th>Example</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Major*10000</td>
      <td>5*10000 = 50000</td>
     </tr>

     <tr>
      <td>Minor*100</td>
      <td>0*100 = 0</td>
     </tr>

     <tr>
      <td>Patch</td>
      <td>7 = 7</td>
     </tr>

     <tr>
      <td>MYSQLND_VERSION_ID</td>
      <td>50007</td>
     </tr>

    </tbody>
   
  </table>

  <p class="para">
   During development, developers should refer to the
   <code class="literal">mysqlnd</code> version number for compatibility and
   version tests, as several iterations of <code class="literal">mysqlnd</code>
   could occur during the lifetime of a PHP development branch with a
   single PHP version number.
  </p>
 </div></div></div></body></html>